استفاده از افزونه RESX بومی سازی برنامه های WPF با استفاده از فایلهای RESX. عنوان مقاله : Localization یا

Transkript

1 در این مقاله بومی سازی )تعیین زبان نمایشی برنامه با توجه به نیاز کاربر( بومی سازی روش های مختلفی وجود دارد که ویژگیهای WPF را از منابع RESX تعبیه شده واکشی کرده و استفاده کنیم. در برنامه های WPF را بررسی خواهیم کرد. برای در اینجا قصد داریم فرمت RESX را معرفی کنیم که اجازه می دهد خواص یا منابع با استفاده از فایل RESX به هر پنجره WPF مدیریت هر خاصیت WPF تعبیه شده میتوانند بومی شوند. روش مشابه به بومی سازی Windows Form است و منابع مربوط یا کنترل در فایلهای RESX جداگانه ذخیره می شوند. در برنامه های بزرگ که تعداد زیادی پنجره وجود دارد آن تعداد منبع در یک فایل مشکل می شود و بومی سازی در این پروژه ها بسیار اهمیت پیدا میکند. می تواند با استفاده از فایل های RESX سایزها و ویژگی های دیگر Layout استفاده کرد. پشتیبانی آسان کرده است. بومی سازی شود. می توان از آنها برای محلی کردن تصاویر مکان ها Built-in تعریف آیکون برای پنجره ها منو ها و نوار ابزار را بسیار افزونه های RESX به شما اجازه می دهند تا یک مقدار دوم یا مجددی برای خاصیت هایی که استفاده میکنید قرار دهید تا زمانی که اگر منابع نتوانستند بارگذاری شوند از آن مقادیر استفاده شود. استفاده از افزونه RESX برای استفاده از این افزونه باید منبع ان را به پروژه خود اضافه کنید )infralution.localization.wpf(. با این کار می توانید از XAML در فایل کالس MArkupExtention خود استفاده کنید. به شما اجازه تعریف مقادیر خواص XAML را می دهد. ResxExtention از مشتق می شوند و خواص را با داده های بازیابی شده از منبع RESX تعبیه شده ارزیابی میکنند. برای

2 مثال Markup زیر خاصیت Text تنظیم میکند: از یک TextBlock را به MyText از منبع MyApp.TestWindow تعبیه شده به نام RESX اگر هنوز منبع را ایجاد نکرده باشید در <TextBlock Text="{Resx ResxName=MyApp.TestWindow, Key=MyText}"/> #MyText به صورت WPF designer مورد نظر هنوز تعریف نشده است. قدم بعدی ایجاد فایل RESX آنگاه می توانید به سادگی فایل RESX با نام TestWindow.resx نشان داده می شود که # مشخص میکند که منبع و تعریف منبع است. فرض کنید پروژه ای با نام MyApp دارید ایجاد کنید و عمل ساخت آن را به تنظیم کنید.یک رشته منبع با نام MyText اضافه کرده و پروزه را مجدد کامپایل کنید. را که در TextBlock نشان داده شده است خواهید دید. اگر Embedded Resouce TestWindow را بازکنید رشته منبع برای اضافه کردن بومی سازی فایل RESX را کپی کرده و نام آن را تغییر دهید. برای مثال برای بومی سازی فارسی فایل RESX را در TestWindow.fr.resx کپی کرده و آن را به عنوان یک منبع RESX تعبیه شده در پروژه استفاده کنید. تنظیم کردن خاصیت ResxName برای عنصر Resx در یک پنجره منجر به تعداد زیادی از کپی XAML خواص متصل بسیار XAML را مختصر میکند. و این اجازه را می دهد که خواص شده را در بابالی بسیاری از عناصر به صورت زیر تنظیم کنید. می شود. استفاده از ResxExtention.DefaultResxName پیوست <Window.ResxName="WpfApp.MainWindow" Language="{UICulture}>" Key اکنون خاصیت ResxName می تواند از عناصر Resx حذف شود. اگر فقط بخواهید خاصیت را مشخص کنید می توانید نام پارامتر را حذف کنید تا اعالن مختصری داشته باشید. <TextBlock Text="{Resx MyText}"/> تنظیمات DefaultResxName Resx را فراهم میکنند. هرچند عنصر FrameworkElement است که ResxName تعریف شود. تغییرCulture )فرهنگ( در زمان طراحی پنجره TestWindow.xaml که به شما امکان انتخاب Culture با استفاده از ویژگی های ضمیمه شده کارمیکنند که با استفاده از عنصر Resx ویژگی در MarkupExtension دیگر کار نخواهد کرد. در این مورد نیاز را باز کنید. باید توجه داشته باشید که در پنجره اصلی دو آیکون برای نمایش وجود خواهد داشت. های استفاده شده در زمان طراحی را می دهد. را انتخاب و از لیست باز شده گزینه مورد نظر خود را انتخاب کنید. مترجم در مربوط به آن تغییر خواهد کرد. بر روی Icon کلیک کرده و Other Culture designer نمایش داده می شود که به فایل Resx

3 در designer یک Visual Studio 2012, 2013 XDesProc shadow استفاده می شود. Expression Blend جدید با نام XDesProc منبع ماهواره آن را نمی تواند کپی کند.به این معنی است که انتخاب این مشکل معرفی شد. اسمبلی های شما را درون Culture راه حلی پیاده سازی کرده ایم که سازنده کالس همانند روند طراحی خارجی توسط دایرکتوری خود کپی میکند اما اسمبلی زمان طراحی با شکست مواجه می شود. برای حل رویداد AssemblyResolve را گرفته و به دنبال آخرین اسمبلی منطبق می گردد. برای تعیین دایرکتوری ها برای جستجو آن را از طریق فرایند های در حال اجرا برای فرایند میزبانی ویژوال استودیو خواهد یافت. به این معناست که اگر از designer ویژوال استودیو استفاده میکنیدو گزینه Enable the Debug setting را در Visual Studio hosting process درستی کار خواهد کرد. اگر این گزینه غیرفعال باشد یا از انتخاب کرده باشید سوئیچ کردن culture Expression Blend جستجو برای اسمبلی ماهواره در زمان طراحی تعریف شود. برای انجام این کار یک مقدار کنید. مقدار آن را لیست مشخصی از دایرکتوری ها برای جستجو تنظیم کنید. استفاده کنید باید در زمان طراحی به string در محل زیر در رجیستری ایجاد HKEY_CURRENT_USER\Software\\AssemblyPath تغییر Culture در زمان اجرا به صورت پویا Culture برنامه شما به راحتی می تواند به صورت پویا در زمان اجرا با استفاده از ویژگی کند. این ویژگی CultureManager.UICulture تغییر CurrentThread.UICulture استفاده میکنند بروزرسانی میکند. را تنظیم میکند و به صورت خودکار همه XAML های فعال را که از تصاویر و آیکون ها فقط برای کار با Text نیست. عالوه بر text می تواند برای تصاویر و آیکون ها نیز بکار رود. براحتی می توان از تصاویر و آیکون های فایل Resx در XAML استفاده کرد. برای تعریف یک آیکون برای یک پنجره یک منبع آیکون را به فایل Resx با نام Window.Icon اضافه کنید سپس نشانه گذاری آن را به صورت زیر تعریف کنید : <Window Icon="{Resx Window.Icon}"/> این کار بسیار راحت تر بومی سازی انواع ویژگی های دیگر از تعریف آیکون در WPF است. از همین روش می توانید برای منوها و نوارابزار نیز استفاده کنید.

4 margin می توناد برای بومی سازی ویژگی ها از هر نوعی استفاده شود. برای نمونه خاصیت می تواند به صورت زیر تعریف شود. از یک textblock <TextBlock Margin="{Resx Key=MyMargin, DefaultValue='18,0,0,71'}"/> در این مثال توجه داشته باشید که یک صفت DefaultValue استفاده می شود. اگر XAML تعریف نکرده باشید ممکن است که DefaultValue تعریف کردیم. اگر منبعی یافت و بارگذاری نشود از این مقدار تواند به عنوان یک رشته ساده )"18,0,0,71"( تعریف شود یا می توانید آن را در فایل Resx آن را در designer بارگذاری نکند. منبع می با یک مقدار کامل تعریف کنید : <data name="mymargin" type="system.windows.thickness, PresentationFramework"> <value>18, 0, 0, 71</value> </data> فرمت اتصال داده ها WPF عنصر Binding برای اتصال ویژگی ها به یک فراهم کردن یک رشته برای استفاده در فرمت داده های نمایشی را Binding.StringFormat را فراهم میکند. ویژگی Datasourec ارائه می دهد: امکان <Binding StringFormat="Selected Item: {0}" ElementName="_fileListBox" Path="SelectedItem"/> برای بومی سازی آن باید تغییر نمیکند. اگر StringFormat خاصی را با استفاده از عنصر Resx تعریف کنیم. با استفاده از آن Culture InvalidOperation را تغییر دهید با خطای culture زمان اجرا با پیام" اتصال نمی تواند بعد از استفاده شدن تغییر کند" مواجه خواهید شد. متاسفانه اتصال با بروزرسانی پویا از Culture طراحی نشده است. برای غلبه به این تواند مانند یک اتصال عمل کند. براحتی می توانید ویزگی های اتصال را تنظیم کنید و مقدار منابع به عنوان استفاده شده است. برای مثال اتصال باال را می توان به صورت زیر نوشت : format stribg می <Resx Key="MyFormatString" BindingElementName="_fileListBox" BindingPath="SelectedItem"/> همچنین می توان یک منبع متفاوت را مشخص کرد که با استفاده از ویژگی BindingTargetNullKey هنگام Targetاز آن استفاده شود. Null بودن

5 قالب داده را از منابع داده ای متعدد با استفاده از عناصر تو در تو Resx پشتیبانی میکند. <Resx Key="MyMultiFormatString"> <Resx BindingElementName="_fileListBox" BindingPath="Name"/> <Resx BindingElementName="_fileListBox" BindingPath="SelectedItem"/> </Resx> در این نمونه باید منبع MyMultiFormatString با Palaceholder برای هر دو آرگومان datasource تعریف شود : "Selected {0}: {1}" گسترش UICulture در این پروژه افزونه نشانه گذاری دیگری نیز با نام UICulture تنظیم می شود برای تطبیق زبان با افزونه میکند. برای تبدیل UICulture نیز در هنگام تغییر تعریف شده است. که برای تنظیم زبان های یک پنجره WPF.)CultureManager.UICulture( مورد نظر در برنامه Culture همانند CultureManager.UICulture Enum ها کالس بومی سازی متن های نمایشی که با ResourceEnumConverter Enum مرتبط هستند فراهم میکند. عناصر پیوست شده را به صورت خودکار بروزرسانی به پروژه اضافه شده است. این کالس یک مکانیزم آسان را برای پنهان کردن پنجره فایل های Resx در solutionexplorer یکی از امکانات جالب Windows Forms Localization آن است که فایلهای اتوماتیک پنهان هستند. برای دیدن این فایلهای Resx Resx مرتبط با یک فرم یا کنترل به صورت بر روی دکمه گسترش فرم یا کنترل کلیک میکنید. به این معناست که اگر زبان های بیشتری به پروژه خود اضافه کنید explorer Solution بهم ریخته نمی شود. همچنین می توانید این کار را برای فایلهای DependentUpon در ارتباط هستند با استفاده از XAML که با فایلهای Resx انجام دهید. <EmbeddedResource Include="TestWindow.resx"> <DependentUpon>TestWindow.xaml</DependentUpon> <SubType>Designer</SubType> </EmbeddedResource> مدیریت طول عمر شیء

6 مدیریت طول عمر شیء یکی از مسائل اصلی در هنگام طراحی یک به صورت خودکار بروزرسانی خواهد شد. نیاز دارد که یک منبع را برای عناصر از آن برای فعال کردن بروزرسانی عناصر هنگام تغییر CultureManager.UICulture قوی است عناصر MarkupExtension است که XAML که از آن استفاده میکند XAML هدف نگهداری کند که WPF extension یک منبع ضعیف از عناصر هدف استفاده کند. هرچند این منبع یک منبع که از extension استفاده کرده اند هرگز جمع آوری نخواهند شد. برای جلوگیری از این وضعیت WPF را نگهداری میکند. که عناصر هدف را برای جمع آوری فعال میکند. تنها مشکل وجود منبع قوی برای گسترش اشیاء است. این موضوع توسط دوره فراخوانی یک تابع پاکسازی که که اهداف فعالی ندارند برطرف می شود. این مدیریت طول عمر در بعضی کالس های پایه ای پیاده سازی شده است و برای هر MarkupExtension داشته باشد استفاده می شود. ضعیف برای اشیاء هدف WPF Extension ManagedMarkupExtension پیاده سازی میکند. کالس یک کالس پایه ای برای هایی را که آن رفتار را نیاز Extension ها فراهم میکند و یک منبع MarkupExtensionManager ManagedMarkupExtension مجموعه ای از اشیاء ها را مدیریت میکند و مکانیزم آپدیت و پاکسازی را پیاده سازی میکند. ManagedMarkupExtension هر دو از UICultureExtensionManager MarkupExtensionManager میکنند. پشتیبانی اتصال داده برای رسیدگی به آپدیت اهداف WPF مشتق شده اند و از یک نمونه استاتیک کالس و هنگام تغییر CultureManager.UICulture استفاده غلبه بر تغییر ناپذیری اتصال داده ها کاری سخت و خسته کننده است. راه حلی کامال ظریف وجود دارد که امکان تنظیم کردن مستقیم ویژگی های اتصال بر روی عنصر نسبت می دهد و Resx را به ما می دهد. Binding.StringFormat را با مقدار منبع تنظیم میکند. زمانی که یک کپی از اتصال ایجاد میکند و هدف را برای استفاده اتصال جدید آپدیت میکند. این ویژگیها را به یک نمونه اتصال اساسی Culture تغییر میکند پشتیبانی Globalizer.NET WPF برای پشتیبانی بومی سازی برنامه های با استفاده از ابزار Globalizer.NET شامل یک رویداد static GetResource می شود که امکان قرار دادن ترجمه منابع به ما می دهد و به صورت پویا ترجمه را برای منابع فراهم میکند. این امکان طراحی شد. کالس Globalizer.NET را درون مکانیزم Globalizer را قادر می سازد ترجمه پنجره ها و کنترل هایی که از بدون داشتن منابع ماهواره ای استفاده میکنند را نمایش دهد. Globalizer.NET شامل قابلیتی برای اسکن پروژه WPF ها است. موجود برای تعیین زبان و به طور خودکار تبدیل آنها به یکدیگر با استفاده از